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Preface 


3 


Gocument describes the Lisa user interface. It is primarily for people 
who want to develop applications for tne Lisa Office System using tne 
Toolkit, but may also be of use to those who just want to learn more 
about the Lisa interface. 


The Lisa user interface is the common part of the ways in which the user 
and the Lisa applications interact. The version of the Interface described 
in this document is the “ideal” version. Usually, but Dy no means always, 
it matcnes the way the applications already released benave. However, 


Gisagree, tne user sould assume that this document describes the way we 
tnink the interface should benave, rather than the way it does benave. 


Eacn section of this document consists of tnree parts: 
1) A general description of the feature from the user’s point of view. 


2) Under tne neacing Details, additional nitty-gritty cetalls about tne 
feature. These cetalls are of Interest only to tnose planning to cevelop 
applications. 


3) Under the heading Implementation, a brief discussion of what a 
Geveloper needs to know in order to implement tne feature. Mostly, tnis 
just tells you whetner the feature is proviced by the Toolkit, and If so, by 

which component. For more details, refer to tne Lisa Applications Toolkit 
reference Manual. 


A note on terminology: Tis cocument mostly doesn’t alstinguisn between 
tnings that are done by the Toolkit and things tnat are cone by an 
application that uses the Toolkit. Therefore, when we say “the application 
Goes this or that,” it may be that actually the Toolkit does it, but from 
tne user's point of view, It is all Gone Dy the application. The only place 
wnere the distinction between the apolication and tne Toolkit is relevant 
ls In the Implementation sections. 


To get the most from tnis document, you smould be pretty familiar with 
the Lisa Office System. It 1s especially nelpful to nave learmmed to use 
Lisawrite, LisaDraw, and eltner LisaCalc or LisaGrapn. Where relevant, 
this cocument takes examples from these and the otner first release 
apolications. 


For those who want to become more familiar witn the Office System, 
hands-on experience is essential. In acaltion, the following materials 
snould de neipful: 


LisaGuide (tne interactive introcuction to Lisa) 
Lisa Owner’s Gulde, section 8, Lisa Fundamentals 
/bid, section 0, Desktop Manager Reference Guice 
Any tool manual, Section C, Chapter 1, Overview 
foid, Section C, Chapter 2, passim 
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The Lisa system !s botn a hardware system and a software system. mis 
Gocument describes the software interface; a orief cescription of the hardware 
is in Appendix A. 


Go when they aren't using Computers, and they are tive because they 
work the way people would expect without giving it mucn thougnt Far 
example, when the user Moves the mouse around, tne pointer moves so quickly 
and conforms so closely to the patn of the mouse tnat the user is not really 
aware of the steps that intervene between the mouse movernent and tne 
painter movement. If the “reaction time” of the pointer were much Slower, 
the user would be aware of the delay, and mouse movernent would seem less 
intuitive. 

2 It is consistent among applications. whenever two apolications do tre 
same tning, ney tend to co it in the same way. 


3) It is rien enough to fit many types of applications. Currently, tne 
applications available inciuce text-oriented applications (Lisawrite), 
grapnics-oriented applications (LisaDrew and LisaProject), taple-orlented 
applications (LisaList and LisaCalc) and one graprics-taple hyorid (LisaGraon). 
More categories, particularly farms, will be adced later. 


8) It 1s friendly and permissive. whenever possible, tne system tries tO pul a 
logical interpretation on user actions. 


The mest important principle for creating a permissive user interface Is the 
abolition of modes. 


A mode |$ a state of the system that tne user nas to formally Degin and end, 
and that restricts the operations ne can perform while It Is In effect 

i$ users, especially naive users, to learn 
and to use mooe-based systems because of the numoer of arbitrary operations 
they nave to memorize. 


we have avoided modes in the Lisa user interface, but we haven't eliminated 
them entirely. we nave used them wherever their value as tne solution to a 
proolem outweigns their inconvenience. Some examples are: 


1) When the application sends the user an alert message waming nim of 4 
potentially serious prodiem, the user must acknowledge the message and ceal 
with the proolem before doing anytning else. AN examole is entering an 
invalic formula in LisaCalic. The user must correct tne formula Defore making 
a selection outside tne cell. 


2) when tne cost of an operation In disk space, memory, or time {s nign, a 
moce can help ensure tnat the user's intentions are completely clear cefcre 


tase 
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tne application performs the operation. For example, in Lisalist, adding ar 
removing a column is a major operation because it restructures the cata base. 


3) Some modes are used because they correspond to the most natural way to 
Go something. An exemple of tnis is the drawing modes In LisaOraw. 
Witnout modes, LisaOraw would not be adle to give approoriate feedback 


The characteristic way of doing tnings In Lisa Is to first select tne thing to 
tne mouse), then choose tne arocropriate menu 


item. You can think of tnis as “object followed vern.” There are two 


by 
1) Things that you oo directly with the mouse, not with a meru item. 
Example: moving an icon from one part of ine desktop to another. 


2) Menu items that operate on something other than the current selection. 
These are usually items (at affect tne whole active cocument. Examole: Tre 
Type Style menu in LisaList and LisaCalc affects the whole cocument, 
regardless of what |s selected, as long as tne cocument is active. 


113 What you see is what you gat 
Lisa applications try to matcn the appearance of the document on the screen 


way 
Called visual fidelity, or “wnat you see Is what you get” ( wys/eyh Of course, 
the different properties of the two media make it impossible to matcn 
exactly, Out it Is very helpful to users to matcn as closely as possible. For 
example, fonts are designed to look as similar as possible on the screen and 


12 Basic mocel 


Figure 1-1 snows the Lisa screen at a typical moment. The packground of 
tne screen |s called the Gesktop; it |s tne comain of the Cesktco Manager. 
On the desktop are various icons, wnicn can be opened up to display their 
contents. Some of the icons represent documents. Right now, twO documents 
are open; that |s, thetr contents are displayed on the screen. Cne of tnese {s 
a Lisawrite cocument, and tne otner ls a LisaGraon cocument. The LisaGracn 


i-Z 
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Gocurmnent is the active cocument; you can tell because its scroll bars are 
gray, with various gacogets in them. 
hem 
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Figure 1-1. Typical Desktop 


Each document belongs to a particular application; wnen tne user activates 
the cocument, that apolication takes over from tne Desktop Manager. ihe 
frame that the cocument appears in {s called a window. The portion of tre 
Gocument visible in the window is called the curemt view, whicn Is one area 
within the document view. The window can be thougnt of as a frame that is 
moved over the uncerlying cocument. oringing different portions of tne 
Gocument into view. The user moves tne frame by scroiling tne cocument, 
using the various mechanisms in the scroll Cars. 


At the too of the screen Is the menu bar, whicn contains the menus belonging 
to the apolication. Menus are the primary way the user tells the application 
what operations to perform. In Figure 1-1, the Grapn menu nes deen pullec 

Gown, and the user nas chosen tne Line menu item 


Witnin a window, the current view can be suddiviced in various ways. For 
example, LisaGraon applications contain panels, such as tne grapn panel and 
tne table panel. Panels usually contain olfferent representations cf the same 
Gata: in this case, tne tadle panel sMows the cata as text, and tne gracn perel 
snows it as a grap. Window can also be diviced into panes. Two pares 
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within a window snow the document in the same way, tut they sfow two 
Gifferent parts of tne document. The Lisawrite document whose wincow 
appears benind the LisaGrapn window Is split Into two panes. 

13 Styles of interaction 


The Lisa user interface nas several different styles of interaction between the 
user and the apoiication. In the first release applications, four styles can be 
loentifiec: text, grapnics, tables, and forms. facn of these styles !s 
appropriate for different situations. Some applications use one style almost 
exclusively; others use different styles In different panels; still others are 
hyorics, using two or more styles simultaneously. 


13.1 Tet 


The text style applies to any Information the user enters from the 

Text can be thougmt of as one long string of characters that {s arranged In 
words and paragcrapns. Nearly every application uses text somewhere: it 
follows tne same rules in every context in which it occurs. 


Figure 1-2 shows a window containing a typical text document (from 


Lisawrite) Terms applicapie to text are illustrated In the figure. These 
terms are discussed later In this document. 
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Figure 1-2. Lisawrite Cocument 


Owtat ls: 


Inplenentation: [In the Toolkat. text 13 sucoorted by the Text Suilding 2lock. Text *nat :s 
Cop1ed of Aoved between applications :3 supported by the Universal ‘ext Interfsce solaing 
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block. 

132 Grapnics 

The grapnics style is used for information that ls conveyed througn pictures 
ratner then worcs. In some products, such as LisaDraw, the user draws 
pictures using the mouse; in others, such 
manipulates pictures drawn by the applica 
thougnt of as a collection of 0b tnat are either separate or arranged in 
groups. A separate oDject can be operated on without affecting any of the 


ieee SS Se 


Figure 1-3. LisaDraw Oocument 


Details: A geonetrically defined object can be scaled nore smoothly than a bit sap. but 3 
bit nep object can snow finer detail. 

Inplemerntztion: In the Toolkit, geometrically defined objects are supported by Ue 
Structured Craofics bunlding block. and bit sap grapfics are supported by the Bit Nao 
grapirics building block. Qsckdraw is also avarlable for custom grapnics. 


133 Tadles 


Tables show cata arranged in a rectangular array of rows and columns. The 
individual unit In the array !s a cell. (Tis Is called a fleld In Lisalst 
cocumentation.) A cell {s a 0ox that may or may not contain a value. Some 
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operations are performed on calls, others on values. The value in a ceil Is a 
text string that can comtain several paragrapms, or be limited dy the 
application to a single one-line paragraon. 


Figure 1-4 shows a wincow containing a typical table document (from 
LisaCaic) andl 
pe 
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Figure 1-4 LisaCalc Oocument 


Osemils: Currently, no application supports sore than one paragraph in e cell. 
Inplanaent.ztiion: 


134 Farms 


A form |s a request for information that the apolication makes to the user. 

It consists of a fixed alrangement of text flelcs, check Doxes, and Cuttons. 

The user provices tne requested Information cy filling in tne fleias and 
tne coxes. A form !s therefore more restrictive tnan the otner 


cnecking 
styles in tne range of operations the user can oo. A clalog pox Is an example 
of a form 


dogg 1-5 snows a window containing a typical form (from tne orintirg cialcg 
DOx 
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A 
Pring... WB Fintsned Quality CM Quick Orart (Text Oniy) tance \ 


Figure 1-5. Print Olalog 80x 
Oetzils: 
Inplenentation: In the foolkit, forns are supported by the Dialog building block. 


135 Hyorics 


The four styles of interaction can be combined in various ways. One covious 
way |s that cells in tables and fleics In forms both contain text Once tne 


cell or fleic nas been selected, the text In it can be edited just like any ower 
text. 


Anotner hypothetical example would be a wOrd Processor that nad a form 
letter feature. In an application Like tnis. each document Is a form with text 
superimposed on it (Figure 1-6} The Diank spaces In tne letter are actually © 
fleics In the form. To complete the letter. tne user fills In tne Olark flelcs 
in the form. The result {s a letter that is Indistinguisnable from one Wal wes 
typed from start to finisn. 
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Figure 1-6. Form Letter 
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Filing operations are covered in the Lisa Owner's Guice; this section gives 
some details about the relationsnip between an application and the Desktop 
Manager. 


S.1 General scheme 


to 
kept in memory at the same time (for example, LisaCalc). these 
applications, any changes the user ept In 
. When the user saves the document, the chances mace to 
Gocument on the disk. If the user chooses Revert to Previous Version, 
changes are nullified. 


In other applications, the user can create cocuments that are too large to fit 
into memory (for example, LisaList). In tnis case, tne application keeps a file 
containing the cnanges to the document. when the user saves the document, 
the application updates it based on the material in the change file. 

Ostails: 

Implenentation: The Toolkit implements all Desktop Manager operations on the assumption 
that the application is following the LisaCalc nodel (whole docunent in nenory). If it 


insteed fallows the LisaList nodel or sone other nodel, the application must redefine 
certain methods to specify supplementary defhevior. 


S2 Oesktop Manager operations 


Tnis section covers tnose aspects of Desktop Manager operations tnat the 
apolication needs to kndw about 


i 
g 
5 
a 
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521 Activate 


The active window is the one the user is currently working on. At mast one 
window on the desktop can be active at a time. 


A window cecomes active in one of tne following ways: 


1) The user opens the document when it is closed. To open the document, 
tne user eitner clicks twice on its icon, or cnooses Cpen from tne File menu 
wnen tne icon. {s selected. 


2) Tne user clicks In the document's wincow when It !s deactivated (see 
section 5.2 for ceactivation. The window Is exactly the same as It was when 
tne user deactivated It, including tne current selecticn and tne position of tre 
Gocument witnin tne window. 


AN active-eisawete document is smown In Figure 8. 


LisaCale 


o71 


Source: David T Craig Page 0011 of 0024 


@ Apple Lisa Computer Information * Lisa User Interface Guidelines Intro (1983) 


user Interface Guicelines Desktop Manager 


4 wish “ 


nae . eer title bor 
6 


File / Pri x Pege Layout / Format Protect Calculate 


oS crecost™ 
6G Cetls: F3 


Bie 
T3001 i700 $4100: NNO. 39700 1690" 
et ae ary ee oc) a rt a 4 
"Revenue _ 2156600: 1221800: 1277200 5648600: .339400_738980§ 
$2000 3Z000'__37900_—«97400: 
18 Je ss 
121600, 123800' 125020 SOLO 1 
: 33400. 11) “TiO 


etna Sateen 
oe Lees sts pee 


Figure 8 Active LisaCalc Document 


Oetails: When a window is active. it hes the following characteristics: 
1) Seroll bars are shown in the window. 

2) The title bar is Mghlignted. 

3) The application's senus are in the nenu bar. 

Inplenentation: Autonetic in the Toolkit. 


S22 Oc5vactivate 


The user ceactivates a window Dy clicking cutsice of [t Wwhen she coes tis, 
the cocument stays just as it is; the application coes not ask ner to finisn 
Going anything. When the user reactivates the window, the applicaticn picks 
up where it left off. 


A deactivated tisaweltecocument is snown in Figure 9. 
LigaCele 
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Figure 9. Deactivated LisaCalc Document 


Details: Uhen the user deactivates a window, the display changes in the following ways: 
1) The scroll bar portion of the window is shown in white. 
2) The title bar is no longer highlighted. 


3) If e selection is visible in the window, it is highlighted with a gray pattem rather 
than in inverse video. 


4) The nenus for the application disappear fron the nenu bar. 


on: fastonatic in the Toolkit. The Tooliit provides « gray pattern for ain 
highligntang, but the application can use its own pattern if 1t wants. Altarnatively, 1t 
can nake the din highlighting look like « reqular selection or like « desalection if 
necessary for sesthetic reasons. 


5235 Set Asice 


When the user sets aside an open cGocument, tne Desktop Manager ceactivates 
it, and its window is smrunk pack to tne original icon. Just as with a 
Oeactivation, the state of the document remains unchanced, so that when tre 
user opens it again, ne can pick up where ne left off. 


To set asice a cocument, the user chooses Set Asice from tne File/Print 
menu If tne user coudle-clicks on tne icon in tne left sice of tne Utle Dar, 
one of two tnings naopens: 


1) If the cocument was on the desktop tne last time sne opened It, It Is set 
aside. 


2) If the aocument was in a container (disk or folcer) tne last Ume sne 
opened it, the Desktco Manager puts up an alert messace, asking Mer wnetner 
sne wants the coocument to be set asice or put away. [TIS May go away.; 


Pie 
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the 
user opens the docunent sqain and chooses Revert to 
ast e 


Save & Continue saves all changes to tne document witnout closing its 
window. The appearance of the window, including the current position and 
unchranged. 


Some applications, such as LisaList, save documents at times other tran when 
the user nas explicitly saved them from the File/Print menu If it ts 


necessary for an application to oo this, it snould warn the user that this Js 
happening. 
Oetzils: 
gre: By default. an active docunent hes two files associated with it: The Save 
@. written to only when the document is saved. and the Suspend file. wich contains the 
t heap awd wich is suapped out fron tine to tine. Saving etas the 


S25 Save & Put Away 
Save & Put Away can nappen In one of three ways: 


1) If tne window {!s open, and the user chooses Save & Put Away, the Desktco 
Geactivates the cocument, saves it contents, and returms to 
tne location of its ghost. It then returns the icon to the container 
most recently. 
top, 


2) If the user nas set aside the document on the desk anc tnen 
Save & Put Away, tne Desktop Manager saves tne contents of tne cocument 
on the container it was In most recently. 

he 


Details: Sone toals (eg Lisacale and Lisalist) sust do sone end processing and consistency 
eel ee te ee If the document is put away wen its window is 
closed ee ee ee ert nessage talling the user that the document sust 
de out amay es oe ha moolication algo isuag wy alert ceieaes 10 che Gare cee 
t/G/ettors Gr hee axsuah aix spece. 


Inplenentation: An apolication keeos a flag called “fCanPutBack” [777] to indicate wnetrer 


putting sway the document could cause invalid data. I[f this flag is false, then the Jesxtoo 
Maeneger puts up an alert nessage: othervise, it puts way the docunent es instructed. 


5.26 Suspend 


The Desktop Manacer suspends a document that is open or set asice in tre 
following cases: 


1) The user tums the power off on tne Lisa 


2) The user ejects a diskette that contains tne application, part of tne 
cocument, or Dom. 


If the document is apen or nas been set asice, then {ts current state |s 
frozen. when (ne user sudsequently recpens it, it smouldc accear exactly ‘re 
same as Cefore. [f the user nas saved and put away tre cocument, a suscerd 
snould nave no effect 


5-4 


Source: David T Craig Page 0014 of 0024 


@ Apple Lisa Computer Information * Lisa User Interface Guidelines Intro (1983) 


User Interface Guidelines Desktop Manager 


Oetails: 
Inplenentation: 


527 Resume from save 


When the user reopens a document after she nas saved It and put It away, the 
application restores its appearance to tne way it wes when it wes saved. 
That is, panels are split the same way and scrolled to 
the same selection {s snown. 

(777 -- this Is a change — comments?] 

Details: 


z 
: 
5 
a 


Inplenentstion: The Toolkit keeps track of splits and scrolling. even sfter a save; the 
application can override these settings. 


5.28 Resume from suspend 


wnen the user powers on tne Lisa after a suspend, or reinserts tne disk whose 
ejection caused the suspend, the Desktop Manager restores the screen to tne 
way it was when tne cocuments were Suspended, except tnat no Information Is 
shown in the windows. Instead, in eacn window, a message appears telling tne 
user to Click In the window If ne wants to see tne cocument. 


The window that was active when the Lisa was suspended !s shown with an 
active title bar, but its menus are not in the menu Car. It nas an active size 
control, but the rest of its scroll bars are shown In gray with no active 
elements [this is also a change} 


If the user clicks In tne scroll pars or ttle par of a suspended wincow, rather 
tnan in the wincow itself, then its document becomes tne active document 
The user can resize or move it, but its contents are not displayed until the 
user clicks In the main part of tne window. At that time, tne document 
snould appear exactly the same way It did when It was suspenced. 

Oetails: If. instead of clicking in @ suspended document, the user requests that it be put 


quay, the docunent is put away by tne Desktop anager. not by the application, and 15 
therefore still 4 


Inplenentztion: 
529 Revert to Previous Version 


Revert to Previous Version restores a Cocument to the way It was tne last 
time it was saved. Usually, this means the last Ume the user explicitly saved 
(t, but in same applications, sucn as LisaList, tnis can mean the last time tne 
application saved it. 


If a cocument is not memory-resident, tne application keeps changes to tre 
document separate from the original version of tne document, as described 
apove (section 5.1) If the document is memory resident, tne application 
keeos a separate, uncnanged copy. 

Oetails: Suspend, deactivate, and set aside do not affect the contents of the current 
version. If the user reactivates the docunent and chooses Revert to Previous Version, the 


phe bah he gets is the last one established by 8 save before the suspend, deactivate, or set 
de. 


Inplenentation: Automatic in tne Toolkit for LisaCale-style applications. For 
Lisatist-style applications, the Toolkit routines are assistec dy application rethods. 
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